home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / admin / studentrec / StudrecDoc / Block < prev    next >
Encoding:
Text File  |  1992-10-21  |  19.0 KB  |  389 lines

  1.  
  2. This is the user manual for !Block. It is based on the Helpreader system
  3. which makes it much easier to use than an ordinary text file. Throughout the
  4. text you will find buttons like this @%start#.  Clicking with SELECT on
  5. these buttons takes you directly to related parts of the manual. To return
  6. to your original position, double-click with ADJUST anywhere in the text.
  7. HelpReader remembers the last 8 positions. Clicking MENU in this window
  8. allows you to choose the topic which interests you and go  straight to it. 
  9.  
  10.                       (@%helpreader# More about Helpreader)
  11. @#purpose
  12.  
  13.                                    !Block
  14.  
  15. !Block is able to do the following things:
  16.  
  17.    (1) Place students in teaching blocks in an optimum fashion, i.e.       
  18.       "block" the students (hence the name).
  19.    (2) Allow yu to rectify "failed" blockings by on-screen editing.
  20.    (3) Assign students to tutors in a sensible way.
  21.    (4) Display the numbers of students in teaching groups and tutor groups.
  22.    (5) Display actual lists of the students in all such groups.
  23.    (6) Split a large group into an 'A' and a 'B' group within the same     
  24.        block (and also reverse the process if you wish).
  25.    (7) Produce individual timetables for students.
  26.    (8) Transfer each and every kind of displayed output either to a text   
  27.        file or directly to the printer.
  28. @#start
  29.  
  30.                                  Starting up
  31.  
  32.   (a) If !Block is already running (i.e. if its icon appears on the icon
  33.       bar) simply drag the required database from the directory window and
  34.       "drop" it on the !Block icon.
  35.  
  36.   (b) If !Block is not running, double-click on its icon in the directory
  37.       window.  Wait for the !Block icon to appear on the icon bar then
  38.       proceed as in (a).
  39.  
  40. After entering your password in the usual way, you will be presented with a
  41. small window which invites you to select the number of blocks to be used.
  42. This is the number of blocks which !Block will read from the student file.
  43. The number actually looked at when blocking the file may be less than this.
  44.  
  45. For instance, if you are using !Block to get information about group sizes
  46. or to print timetables, you probably want to read all the blocks in the
  47. database. This value (currently 7) is offered as a default and you need only
  48. click on 'OK'. If doing an actual blocking on a new intake you will only be
  49. concerned with the first five blocks at most; perhaps even the first four.
  50. This is just as well since blocking slows down dramatically as the number
  51. of blocks increases. To block with 5 blocks takes 5 times as long as with 4.
  52. For 6 blocks the time is 6 times as long as for 5, and for 7 blocks the time
  53. is 7 times as long as for 6! If you ARE blocking and happen to enter 6 or 7
  54. at this initial stage it doesn't matter because you will be offered the
  55. choice again when you select 'Block students' from the menu.
  56.  
  57. Once !Block knows how many blocks you wish to know about it will read the
  58. database and create, in memory, a list of the students in Subfile 0. It is
  59. assumed that only the records in subfile 0 are of interest to the user of
  60. !Block.  The hourglass shows the progress of this read operation. When
  61. completed, the student list, showing names, subjects taken and tutors is
  62. displayed in a window. Saving and printing this list are described below.
  63.  
  64. @#save
  65.                     Saving and printing displayed data
  66.  
  67. To save the data displayed in a window in !Block click MENU with the mouse
  68. pointer over the window. The menu displayed varies in complexity from one
  69. window to another, but one entry usually leads to a 'Save' box. In some
  70. cases there will be nothing else except the 'Save' box. The writable icon
  71. in the 'Save' box offers a sensible default file name and simply typing
  72. RETURN or clicking the OK button with SELECT will save the data as a text
  73. file under that name in the 'PrintJobs' subdirectory of the database's
  74. application directory. You may delete the name up to the last full-stop
  75. (but not the full-stop itself), type a new name and save it in 'PrintJobs'
  76. using RETURN or SELECT on OK. You may also delete the entire contents of the
  77. writable icon with CTRL-U then enter a new name and drag the icon, using
  78. SELECT, to any filer window.
  79.  
  80. The above paragraph describes the standard RISC OS method of saving a file.
  81. If it is already familiar to you it will come as no surprise to learn that
  82. you can drag the file icon straight to the printer icon (if the latter is
  83. displayed on the icon-bar) for immediate printing. Text files saved on disc,
  84. e.g. in 'PrintJobs' can be dragged out of their directories to the printer
  85. icon. Note that there is also an item, 'Show jobs done', on the main menu to
  86. display the 'PrintJobs' directory.
  87.  
  88. The only case where saving is a little different is in the case of
  89. validation tables @%table#. These MUST be saved to a specific place in the
  90. database application and !Block therefore gives you no choice in the matter,
  91. providing merely the word 'Save' when you open a menu over such a table.
  92.  
  93.  
  94. @#edit
  95.                              Editing the list
  96.  
  97. The first item on the menu varies according to where the mouse pointer is
  98. when you click MENU. If you are pointing at a student's name, or at the
  99. blank space after the name, the entry will say <null> and will probably be
  100. greyed out as well. When you click over a subject or tutor code however,
  101. that code appears in the menu item. A right arrow leads to a writable
  102. sub-menu item into which a different code (or no code at all) may be
  103. entered. On typing RETURN or clicking with SELECT the old code is replaced
  104. by the new. Group totals @%total# are automatically updated, as you will see if
  105. you make such changes with the 'Group sizes' window for subjects or tutors
  106. open.
  107.                                            
  108. @#subblock
  109.                              Subject blocking
  110.  
  111. This entry leads to a sub-menu which gives access to the blocking routine
  112. itself ('Do blocking' @%block#) and to choices which will display various types of
  113. information in separate windows - the Group sizes @%total#, Block weightings @%weight#
  114. and Problem cases @%problem#. The latter will be greyed out if you have just read
  115. the database but not blocked it yet.
  116.  
  117. @#total
  118. Group sizes
  119.  
  120. Selecting this menu choice opens another window over the first. The
  121. appearance of the two windows is rather similar but, instead of a list of
  122. student names, it contains a list of subject names. Under the block headings
  123. are the numbers of students in each block, a final column giving the grand
  124. total for each subject. If the file has never been blocked @%block# these numbers
  125. will have little meaning. If the file has been blocked, a zero in a column
  126. probably means that the subject is not available in that block. If a subject
  127. has two teaching groups in the same block, e.g. BL1A and BL1B, their numbers
  128. are added together to give a single number for BL1. The total for each
  129. subject is also given in an extra column headed ALL.
  130.  
  131. If you point to any of the numbers in the table and click MENU you can
  132. choose to print a list of the students making up the relevant total. This
  133. list will appear in yet another window and takes the same form as the main
  134. file-list which you saw first.
  135.                                                             
  136. @#weight
  137. Block weightings
  138.  
  139. This choice displays a window very similar to the one used for the group
  140. sizes @%total# except that the numbers under the block headings are likely to
  141. all be either 0 or 500. A value of 0 means that the relevant subject is
  142. offered in that block, a value of 500 means that it isn't. The blocking 
  143. routine @%block# makes use of these weightings and there are occasions when
  144. you may find it advantageous to alter them yourself, e.g. to change the
  145. blocks in which a subject is available.  To do this, point the mouse at the
  146. number you wish to change and click MENU. A short menu appears, the first
  147. item of which indicates the subject and block which you have pointed to.
  148. Moving the pointer over the right-pointing arrow takes you to a writeable
  149. menu item which shows the current weighting. Type in the new value and then
  150. either click SELECT or press RETURN. To allow a block which was previously
  151. unavailable, change 500 to 0. To prohibit a previously available block
  152. change 0 to 500.
  153.  
  154. There is another reason why you might want to alter the weightings, but this
  155. is left for later discussion @%double#.
  156.                                                         
  157. @#block
  158. Do blocking                           
  159.  
  160. Choosing this option starts the blocking process without further ado, but it
  161. should be noted that the changes which result from it affect ONLY THE LIST
  162. IN MEMORY. The actual DISC DATABASE will not be changed until you choose the
  163. 'Write to database' option from the menu. You may therefore experiment with
  164. different block-availabilities @%weight# without doing anything irrevocable.
  165.  
  166. You may continue with other jobs whilst blocking is in progress. As long as
  167. the mouse pointer is over the small green window the hourglass keeps you
  168. informed of how much of the job has been completed. When the blocking is
  169. complete the window will be redrawn. You will then see that most of the
  170. student entries are printed in blue. These are the ones which have been
  171. successfully blocked. Where blocking has failed the entry will be in red.
  172.  
  173. @#problem
  174. Show problems
  175.  
  176. This option gives a list of those students for which blocking failed. The
  177. reason for failure can always be traced to a combination of subjects which
  178. simply cannot be timetabled. The commonest instances of this are of two
  179. single-block subjects which occur in the same block or two double-block
  180. subjects in the same pair of blocks together with a third subject offered
  181. only in one of these blocks. Place the Problems window and either the
  182. Weightings window or Subject validation table @%table# side-by-side on the screen
  183. and try to find the errors. Corrections may be made by editing in the main
  184. window @%edit# (not the 'Problems' window) and might involve removing a
  185. subject or changing it for an acceptable alternative (e.g. ELL in place of
  186. ELI or MAT in place of MST). When you think you have solved all the
  187. anomalies you might wish to write the blocked data back to the database
  188. @%update#. On the other hand, you might want to assign tutors first @%tutor#.
  189.  
  190. @#double
  191.                         Double groups in the same block
  192.  
  193. A group which is too large may be split (subject to availability of staff
  194. and rooms) and !Block will do this for you. The method of listing the
  195. students in a group has already been described @%total#. The menu which may be
  196. opened over the resulting window contains an option to 'Split group'. If you
  197. choose this, the window will be redrawn after a short delay and will now
  198. display the list split into two halves. The split is performed by assigning
  199. students alternately to the two sub-groups. When the data is sent back to
  200. the database @%update# the upper half of the list will be written to the 'A'
  201. block and the lower to the 'B' block. If you use !Block to read a database
  202. which already contains such split groups you will find that they are 
  203. recognized as such when you display the group as described, even though the
  204. two sub-group totals are lumped together in the 'Group sizes' table. 
  205.  
  206. Once a group is split the 'Split group' menu entry is greyed out, but the
  207. 'Join halves' entry is enabled instead so that you can undo the split if
  208. you wish. Please note that groups splits will be "forgotton" if the file
  209. is re-blocked.
  210.  
  211. If you have 30 students applying for a single block subject there is no
  212. problem since the situation can be handled as just described. A more complex
  213. situation occurs where students taking a TWO-block subject have to be split
  214. into THREE groups. Suppose, for example, that Psychology is offered in
  215. blocks 1 and 2 and there are 48 students taking it. It is decided that block
  216. 1 will contain two groups (BL1A and BL1B), and block 2 will contain one
  217. group. We want these three groups to be roughly equal in size.
  218.  
  219. !Block, however, knows nothing of your special intentions with regard to
  220. block 1. As far as it is concerned there are 48 students to distribute as
  221. evenly as possible between blocks 1 and 2. You will therefore end up with
  222. about 24 in each block, whereas what we require is 32 in block 1 (to be
  223. split later into A and B groups) and 16 in block 2. To achieve this we must
  224. fool !Block into favouring block 1 over block 2. This can be done by
  225. altering the intial weighting of Psychology block 2 from 0 to about 16 
  226. BEFORE we attempt the actual blocking. !Block then thinks that block 2
  227. already contains 16 students, i.e. that it has to deal with 64 students
  228. instead of 48. It will attempt to distribute these so that you have 32 in
  229. each block. The 32 in block 1 will all be real, but only 16 of the  block 2
  230. students are real - the other 16 are figments of your imagination. When you
  231. display the totals after blocking only the numbers of real students are
  232. shown!
  233.  
  234. Similar considerations apply when fitting 4 groups to a three-block subject
  235. or 5 groups to a four-block subject. Two examples follow.
  236.  
  237. (1) 68 Physics students to be placed in blocks 1, 2 and 3. Block 2 is to
  238.     ====================================================================
  239.     contain 2 groups.
  240.     =================
  241.     There are 4 groups altogether, therefore the average group size is 17.
  242.     The ideal numbers in the three blocks are 17, 34 and 17 respectively.
  243.     Set the weightings of each ofblocks 1 and 3 to 17 before blocking.
  244.  
  245. (2) 80 Mathematics students to be placed in blocks 1, 2, 3 and 4. Block 3
  246.     =====================================================================
  247.     is to contain 2 groups.
  248.     =======================
  249.     There are 5 groups, giving an average groups size of 16.
  250.     Ideal block numbers are 16, 16, 32 and 16 respectively.
  251.     Set weightings of each of blocks 1, 2 and 4 to 16 before blocking.
  252.  
  253. The above procedures will not always yield the best results. It may be
  254. necessary to bias !Block further by increasing the weightings beyond the
  255. values given.
  256.  
  257. @#tutor
  258.                               Tutor groups
  259.  
  260. Once all students are in the right subject blocks they must be assigned to
  261. course tutors. Before !Block can do this for you it is necessary to complete
  262. the 'Tutors' validation table @%table#. This contains a row for each tutor in
  263. the year, the data in each row consisting of the following:
  264.  
  265.     (a) The staff code for the tutor
  266.     (b) A single letter code specifying the tutor's type of work. The codes
  267.         used are:
  268.                   A   Arts & Humanities A-level
  269.                   C   Creative Arts
  270.                   H   Health Studies (BTEC)
  271.                   M   Lancashire Music Foundation
  272.                   S   Science & Maths A-level
  273.  
  274.     (c) The maximum size allowed for the tutor group
  275.     (d) The classes taught in the relevant year. Class codes take the
  276.         form CHE4A, COM3B etc. A space or some such separator must be
  277.         left between classes.
  278.  
  279. Assign tutors
  280.  
  281. This will allocate students to tutors according to the following rules,
  282. which are applied in the order stated. A student taking CHE, BIO and GEO is
  283. used as an illustration.
  284.  
  285. (1) Student is basically a science student. Therefore, are any of the tutors
  286. his CHE or BIO teacher?  This would be the favoured choice, provided the
  287. maximum group size wouldn't be exceeded.
  288.  
  289. (2) If we can't give him one of his science teachers as a tutor, what about
  290. his GEO teacher?
  291.  
  292. (3) If he can't be placed with any of his own subject teachers, is there
  293. another teacher of CHE or BIO who is a tutor?
  294.  
  295. (4) If not, is there another GEO teacher who is a tutor?
  296.  
  297. (5) if we still haven't placed this student, put him in the smallest of the
  298. Science/Maths tutor groups.
  299.  
  300. 'Problem cases' (if any) are displayed exactly as for subject blocking @%problem#.
  301. Group sizes may be displayed in a small window of their own and a click with
  302. MENU over any line will list the students in that group, just like it does
  303. for subject groups @%total#. Tutors may be changed @%edit# and the changing totals
  304. will be automatically updated in the 'Group totals' window.
  305.  
  306. @#table
  307.                             Validation tables
  308.  
  309. This option on the main menu allows you to display most of the validation
  310. tables used by !Block. As always, when a program is able to display a
  311. validation table the user is able to edit and save it (subject to having the
  312. appropriate password). The menu produced by clicking MENU over the Subject
  313. list contains an entry to 'Update weightings'. You MUST choose this if
  314. changes made here to the blocking are to be reflected in the weightings and
  315. therefore used when the students are blocked. Validation tables can also
  316. usually be sorted.
  317.  
  318.  
  319. @#update
  320.                              Write to database
  321.  
  322. When you have blocked the students in a satisfactory way and solved all the
  323. problems you will want to finalise the blocking by writing the blocked data
  324. back to the database. When you choose this option you will be asked to
  325. confirm that this is really what you wish to do.
  326.  
  327. @#time
  328.                               Print timetables
  329.  
  330. @%one# individual
  331. @%group# tutor groups
  332. @%all# everyone
  333.  
  334. @#one
  335. If you point the mouse pointer at a name in the student list, click MENU
  336. and then follow the right arrow from the Print timetables entry you will
  337. find the name of the chosen student at the top of the new submenu. Clicking
  338. on this will generate the timetable and display it in a window, from which
  339. it may be saved and printed @%save#. An easier method is simply to point at the
  340. name in the list and double-click with SELECT. 
  341.  
  342. @#group
  343. The second option on the timetables submenu allows you to print the time-
  344. tables for all students in a tutor group. Simply type in the tutor code and
  345. click OK. A single file is created containing all the relevant timetables.
  346. If you enter ALL instead of a tutor code then the file will contain sets
  347. of timetables for all tutors. The List codes button will show you who the
  348. tutors are and what are their codes. 
  349.  
  350. When sent to the printer the timetables are printed two to an A4 page. If
  351. a file contains ALL tutor groups and a group contains an odd number of
  352. students timetable for the last student in the group will be on a page by
  353. itself so that distributing the timetables to tutors doesn't involve
  354. cutting pages.
  355.  
  356. @#all
  357. Timetables for all the students in the year, in alphabetical order, can be
  358. produced by choosing 'Everyone in file' from the timetables submenu. The
  359. timetables will, when sent to the printer, appear two to an A4 page.
  360.                          
  361. @#closedown
  362.                                  Closing down
  363.  
  364. Open the icon-bar menu by clicking MENU over the !Block icon.  If you have
  365. finished with !Block choose 'Quit'.  If, however, you have work to do using
  366. another database choose 'Close database' instead. 
  367.   
  368. @#credits
  369. *************************************************************************
  370.  
  371.  Interface Manager 2.00
  372.  © Simon Huntingdon
  373.  
  374.  Provides 'three dimensional' icons. Interface Manager is Public Domain and
  375.  is not part of !Block.
  376.  
  377. *************************************************************************
  378.  
  379.  Sliding Heap 2.00
  380.  © Steven Haslam
  381.  
  382.  The Sliding Heap Manager is Public Domain and is not part of !Block.
  383.  Details are available from 'Heap Support' at the address below.
  384.  
  385. *************************************************************************
  386.  
  387.  !Block version 3.00
  388.  © Derek Haslam
  389.